home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / dirchk2.zip / DIRCHK2.DOC < prev    next >
Text File  |  1985-08-04  |  4KB  |  73 lines
  1.                       Dirchk2 & Notlist Documentation
  2.                                Daniel Doman
  3.                                    SYSOP
  4.                                  PCSI BBS
  5.                                212-924-6598
  6.                            Registration Required
  7.  
  8.    These programs are supplied as is, and without any express warranty.
  9.                                   8-4-85
  10.  
  11.  
  12.      These programs are designed to aid in the maintainance of bulletin
  13. board download directories. As systems get larger, it becomes increasingly
  14. difficult to keep track of all of the files. My own bulletin board - PCSI
  15. in NY,NY has more than 1700 files distributed accross 8 subdirectories, and
  16. four drives. I was quite shocked by how many files these programs flagged.
  17.      These two programs are intended for RBBS style directories. NOTLIST
  18. will work on directory listings from any BBS system, but DIRCHK2 will only
  19. work on RBBS directories. This is because DIRCHK2 looks for a '-' in
  20. columns 24, and 28. That indicates that the line being processed contains a
  21. file, and is not just a piece of header information.
  22.      These two programs run quickly because they process in memory. They
  23. read your disk directories, and store the filenames into an allocated block
  24. of memory. They can handle up to 3000 filenames. If you have more than
  25. that, have the programs process subsets of your system, rather than all
  26. listings at once.
  27.  
  28.                                   DIRCHK2
  29.                                   -------
  30.  
  31.       DIRCHK2 scans your download directory listings, and flags those files
  32. that are listed, but not actually present on your drives. It will output to
  33. the screen, but can also optionally output to a printer, a file, and edit
  34. out the missing files from the download listings. If you choose to use the
  35. edit option, it is a good idea to have the program also output to a file so
  36. that you will have a record of what files were deleted from the listing.
  37. DIRCHK2 saves your original file with a ."OLD" extension when you use the
  38. edit option.
  39.     You can specify your directory listings with wildcards e.g.. *.DIR, or
  40. DIR??. You can specify up to SIX groups of listings, so you can have the
  41. program process listings with varied names like *.DIR, ALPHADIR, and
  42. DATEDIR. After you specify your directory files, you then specify where
  43. DIRCHK2 will look for files. You can specify up to 25 different drives &
  44. subdirectories e.g.. D:\UPLOAD etc..
  45.     After you specify your download listings, and the drives, and
  46. subdirectories where your files can be found, you will be asked if you want
  47. printer output, file output, and if you want DIRCHK2 to edit the download
  48. listings. The program interprets any character other than a 'Y' or 'y' as a
  49. "no". You can simply hit your return key to skip an option.
  50.    If you have text in your headers that contains a line of dashes, don't
  51. be surprised if DIRCHK2 flags this as a missing file. If your text has a
  52. '-' in the two places that DIRCHK2 looks to confirm that this is not a line
  53. of text, it assumes that the line contains a filename.
  54.    DIRCHK2 took about 15 minutes to scan through 1700 files, and ten
  55. download listings.
  56.  
  57.  
  58.                                   NOTLIST
  59.                                   -------
  60.  
  61.    NOTLIST does the opposit of what DIRCHK2 does. It scans your directory
  62. listings, and indicates what files are on your drives, BUT NOT listed on
  63. your download directories. It does not offer an edit option, and WILL work
  64. with download listings generated by any BBS program that I am aware of. It
  65. uses a priority scan routine, and runs very, very quickly. When I first ran
  66. NOTLIST, it found almost three pages of unlisted files.
  67.     If you have NOTLIST output to a file, don't be surprised if it flags
  68. this as an unlisted file. Think about it. It makes sense.
  69.  
  70.  
  71.     You can specify all input and output files with drives, and path
  72. specifiers e.g.. e:\LISTINGS\*.DIR
  73.